
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

<HTML>

<HEAD>
   <TITLE>wnsumd_c</TITLE>
</HEAD>

<BODY style="color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
<A name="TOP"></A>

<table style="text-align: left; margin-left: auto; margin-right: auto; width: 800px;"
 border="0" cellpadding="5" cellspacing="2">
  <tbody>
    <tr>
      <td style="background-color: rgb(153, 153, 153); vertical-align: middle; text-align: center;">
      <div align="right"> 
      <small><small><a href="index.html">Index Page</a></small></small>
      </div>
      <b>wnsumd_c</b> </td>
    </tr>

    <tr>
      <td style="vertical-align: top;">

<small><div align="center">
<A HREF="index.html#A">A</A>&nbsp;
<A HREF="index.html#B">B</A>&nbsp;
<A HREF="index.html#C">C</A>&nbsp;
<A HREF="index.html#D">D</A>&nbsp;
<A HREF="index.html#E">E</A>&nbsp;
<A HREF="index.html#F">F</A>&nbsp;
<A HREF="index.html#G">G</A>&nbsp;
<A HREF="index.html#H">H</A>&nbsp;
<A HREF="index.html#I">I</A>&nbsp;
<A HREF="index.html#J">J</A>&nbsp;
<A HREF="index.html#K">K</A>&nbsp;
<A HREF="index.html#L">L</A>&nbsp;
<A HREF="index.html#M">M</A>&nbsp;
<A HREF="index.html#N">N</A>&nbsp;
<A HREF="index.html#O">O</A>&nbsp;
<A HREF="index.html#P">P</A>&nbsp;
<A HREF="index.html#Q">Q</A>&nbsp;
<A HREF="index.html#R">R</A>&nbsp;
<A HREF="index.html#S">S</A>&nbsp;
<A HREF="index.html#T">T</A>&nbsp;
<A HREF="index.html#U">U</A>&nbsp;
<A HREF="index.html#V">V</A>&nbsp;
<A HREF="index.html#W">W</A>&nbsp;
<A HREF="index.html#X">X</A>&nbsp;
</div></small>
       <br>
       <table style="text-align: left; width: 60%; margin-left: auto; margin-right: auto;"
       border="0" cellspacing="2" cellpadding="2">
        <tbody>
          <tr>
            <td style="width: 50%; text-align: center;">
            <small>
              <a href="#Procedure">Procedure<br></a>
              <a href="#Abstract">Abstract<br></a>
              <a href="#Required_Reading">Required_Reading<br></a>
              <a href="#Keywords">Keywords<br></a>
              <a href="#Brief_I/O">Brief_I/O<br></a>
              <a href="#Detailed_Input">Detailed_Input<br></a>

              </small>
              </td>
              <td style="vertical-align: top; width: 50%; text-align: center;">
              <small>               <a href="#Detailed_Output">Detailed_Output<br></a>
              <a href="#Parameters">Parameters<br></a>
              <a href="#Exceptions">Exceptions<br></a>
              <a href="#Files">Files<br></a>
              <a href="#Particulars">Particulars<br></a>
              <a href="#Examples">Examples<br></a>

              </small>
              </td>
              <td style="vertical-align: top; width: 50%; text-align: center;">
              <small>               <a href="#Restrictions">Restrictions<br></a>
              <a href="#Literature_References">Literature_References<br></a>
              <a href="#Author_and_Institution">Author_and_Institution<br></a>
              <a href="#Version">Version<br></a>
              <a href="#Index_Entries">Index_Entries<br></a>
             </small>
            </td>
          </tr>
        </tbody>
</table>

<h4><a name="Procedure">Procedure</a></h4>
<PRE>
   void wnsumd_c ( SpiceCell      * window,
                   SpiceDouble    * meas,
                   SpiceDouble    * avg,
                   SpiceDouble    * stddev,
                   SpiceInt       * shortest,
                   SpiceInt       * longest   )              
</PRE>
<h4><a name="Abstract">Abstract</a></h4>
<PRE>
 
   Summarize the contents of a double precision window. 
 </PRE>
<h4><a name="Required_Reading">Required_Reading</a></h4>
<PRE>
 
   <a href="../req/windows.html">WINDOWS</a> 
 </PRE>
<h4><a name="Keywords">Keywords</a></h4>
<PRE>
 
   WINDOWS 
 

</PRE>
<h4><a name="Brief_I/O">Brief_I/O</a></h4>
<PRE>
 
   VARIABLE  I/O  DESCRIPTION 
   --------  ---  -------------------------------------------------- 
   window     I   Window to be summarized. 
   meas       O   Total measure of intervals in window. 
   avg        O   Average measure. 
   stddev     O   Standard deviation. 
   shortest, 
   longest    O   Locations of shortest, longest intervals. 
 </PRE>
<h4><a name="Detailed_Input">Detailed_Input</a></h4>
<PRE>
 
   window      is a window containing zero or more intervals. 

               window must be declared as a double precision SpiceCell.
 </PRE>
<h4><a name="Detailed_Output">Detailed_Output</a></h4>
<PRE>
 
   meas        is the total measure of the intervals in the input 
               window. This is just the sum of the measures of the 
               individual intervals. 

   avg         is the average of the measures of the intervals in 
               the input window. 

   stddev      is the standard deviation of the measures of the 
               intervals in the input window. 

   shortest, 
   longest     are the locations of the shortest and longest 
               intervals in the input window. The shortest interval 
               is 
 
                  [   SPICE_CELL_ELEM_D( window, shortest   ),
                      SPICE_CELL_ELEM_D( window, shortest+1 )   ] 

               and the longest is 

                  [   SPICE_CELL_ELEM_D( window, longest   ),
                      SPICE_CELL_ELEM_D( window, longest+1 )   ] 

               shortest and longest are both zero if the input window 
               contains no intervals. 

               If window contains multiple intervals having the shortest
               length, shortest is the index of the first such interval.
               Likewise for the longest length.

               Indices range from 0 to N-1, where N is the number of
               intervals in the window.
</PRE>
<h4><a name="Parameters">Parameters</a></h4>
<PRE>
 
   None. 
 </PRE>
<h4><a name="Exceptions">Exceptions</a></h4>
<PRE>
 
   1) If the input window does not have double precision type,
      the error SPICE(TYPEMISMATCH) is signaled.
  </PRE>
<h4><a name="Files">Files</a></h4>
<PRE>
 
   None. 
 </PRE>
<h4><a name="Particulars">Particulars</a></h4>
<PRE>
   This routine provides a summary of the input window, consisting 
   of the following items: 

      - The measure of the window. 

      - The average and standard deviation of the measures 
        of the individual intervals in the window. 

      - The indices of the left endpoints of the shortest 
        and longest intervals in the window. 

   All of these quantities are zero if the window contains no 
   intervals. 
 </PRE>
<h4><a name="Examples">Examples</a></h4>
<PRE>
 
   Let a contain the intervals 

         [ 1, 3 ]  [ 7, 11 ]  [ 23, 27 ] 

   Let b contain the singleton intervals 

         [ 2, 2 ]  [ 9, 9 ]  [ 27, 27 ] 

   The measures of a and b are 

         (3-1) + (11-7) + (27-23) = 10 

   and 

         (2-2) + (9-9) + (27-27) = 0 

   respectively. Each window has three intervals; thus, the average 
   measures of the windows are 10/3 and 0. The standard deviations 
   are 

        ---------------------------------------------- 
       |          2         2          2 
       |     (3-1)  + (11-7)  + (27-23)           2             1/2 
       |     ---------------------------  - (10/3)       = (8/9) 
       |                3 
     \ | 
      \| 

   and 0. Neither window has one &quot;shortest&quot; interval or &quot;longest&quot;
   interval; so the first ones found are returned: shortest and longest
   are 0 and 2 for a, 0 and 0 for b.
 </PRE>
<h4><a name="Restrictions">Restrictions</a></h4>
<PRE>
 
   None. 
 </PRE>
<h4><a name="Literature_References">Literature_References</a></h4>
<PRE>
 
   None. 
 </PRE>
<h4><a name="Author_and_Institution">Author_and_Institution</a></h4>
<PRE>
 
   N.J. Bachman    (JPL)
   H.A. Neilan     (JPL) 
   W.L. Taber      (JPL) 
   I.M. Underwood  (JPL) 
 </PRE>
<h4><a name="Version">Version</a></h4>
<PRE>
   -CSPICE Version 1.0.1, 27-JAN-2009 (EDW)

      Corrected argument names shown in Brief I/O list.
      &quot;short&quot; to &quot;shortest&quot;; &quot;long&quot; to &quot;longest&quot;.
 
   -CSPICE Version 1.0.0, 29-JUL-2002 (NJB) (HAN) (WLT) (IMU)
</PRE>
<h4><a name="Index_Entries">Index_Entries</a></h4>
<PRE>
 
   summary of a d.p. window 
 </PRE>
<h4>Link to routine wnsumd_c source file <a href='../../../src/cspice/wnsumd_c.c'>wnsumd_c.c</a> </h4>

      </td>
    </tr>
  </tbody>
</table>

   <pre>Wed Jun  9 13:05:33 2010</pre>

</body>
</html>

